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About This Book 


This book contains summaries of the Dialog Tag Language Guide and Reference 
and the Dialog Manager Guide and Reference. The Dialog Tag Language Guide 
and Reference presents Dialog Tag Language (DTL), the markup language that 
you will use to create displayable panels, messages, key mapping lists, and 
other dialog elements for Dialog Manager applications. 

Use this book with the Dialog Tag Language Guide and Reference and the 
Dialog Manager Guide and Reference. The Dialog Tag Language Guide and 
Reference will guide you in creating, compiling, and storing dialog elements for 
Dialog Manager applications, and the Diaiog Manager Guide and Reference will 
instruct you in using the Dialog Manager services. 


Who Should Read This Book 

The intended audience for this book is application developers, although others 
involved in designing and creating DM applications will also find this book 
useful. This book assumes you are already familiar with designing DM 
applications and have a fundamental knowledge of programming concepts. 


How This Book is Organized 

The summary information is divided into two sections: the Dialog Tag Language 
Reference Summary and the Dialog Manager Reference Summary. The Dialog 
Tag Language Reference Summary section contains the following sections: 

DTL Tag Summary 

This section includes genera) rules for tag markup entry and gives 
a brief description and syntax diagram for each tag. 

Nesting Order of DTL Tags 

This section includes syntax diagrams, indicating which tags are 
repeatable, to guide you in creating dialog elements. 

DTL Commands Summary 

This section lists general rules that apply to all commands and 
shows the syntax for the DTLC and DTLD commands. 

DTLC and DTLD Exit Values 

This section describes the meaning of each exit value for DTLC 
and DTLD and displays the result of each exit value. 

DTLC Country-ID List 

This section lists the valid country-IDs and country codes for the 
/COUNTRY parameter of the DTLC command. 

DTLC Language-ID List 

This section lists the valid language-IDs and language files for the 
/LANGUAGE parameter of the DTLC command. 

Markup Declaration 

This section includes examples and explanations of Document 
Type Declaration and Entity Declaration with syntax diagrams. 
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Predefined Symbols 

This section lists symbols to use when certain keyboard 
characters are unavailable or to specify as part of your tag data a 
special character that has a reserved meaning in GML syntax. 

The Dialog Manager Reference Summary contains the following sections: 

Dialog Manager Services Summary 

This section lists the dialog services along with a brief description 
and syntax diagram. 

Dialog Manager Commands and Descriptions 

This section lists and briefly describes the Dialog Manager system 
commands. 

System Variables 

This section briefly describes the system variables, including 
variable type and maximum variable length. 


Related Publications 

Use this reference summary in conjunction with the: 

• Dialog Tag Language Guide and Reference, which contains complete 
information on creating dialog elements for Dialog Manager applications. 

• Dialog Manager Guide and Reference , which provides a complete 
description of the Dialog Manager services and syntax and demonstrates 
how to use them to create DM applications. 

Refer to the OS/2 Getting Started book for information about how to name files. 

Also refer to the “Technical Bulletin" section of the OS/2 Product Information 

book for information regarding an OS/2 Standard Edition Version 1.2 update. 

This update will contain additional rules for naming files. 
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Dialog Tag Language Tag Summary 


General Rules for Markup Entry 

The following rules apply when you use the Dialog Tag Language (DTL). 

• Tags are delimited by a set of symbols that distinguish them from the text of 
the markup. 

• Tags are delimited by * < * and * > *. Text not within the delimiters is called 
tag content and is subject to translation. 

• Tags in a source file can be entered in either uppercase or lowercase. 

• You can determine characteristics of a tag definition with attributes that 
specify values for the tag. 

• Attribute values that include blanks or characters other than A through Z, 0 
through 9, (-), or (.) must be enclosed within single or double quotes. 

• If an end tag is required, the tag definition must be explicitly ended for the 
source file to compile properly. 

• Many tags can be nested or specified within other tags. 


How to Read the Syntax Diagrams 

Throughout this book, syntax is described using the structure defined below. 

• Read the syntax diagrams from left to right, from top to bottom, following 
the path of the line. 

The ► » — symbol indicates the beginning of a statement. 

The — ► symbol indicates that the statement syntax is continued on the 
next line. 


The ►— symbol indicates that a statement is continued from the previous 
line. 

The — symbol indicates the end of a statement. 

Diagrams of syntactical units other than complete statements start with the 
►— symbol and end with the — ► symbol. 

• Required items appear on the horizontal line (the main path). 

►•—STATEMENT requl red-1 tea ► 


Optional items appear below the main path. 

►* STATEMENT- 


L-optlonal-lteo-J 


• If you can choose from two or more items, they appear vertically, in a stack. 

If you must choose one of the items, one item of the stack appears on the 
main path. 
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►^—STATEMENT 1 — requl red-choi cel — r 

' — requl red-choi ce2 — ' 


If choosing one of the items is optional, the entire stack appears below the 
main path. 


**— STATEHENT- 


ttlonal-cholcel — 
ttlonal-chotceZ — ■ 


• Parameters that are underscored are default parameters. If you don't write 
it in the statement, you will get the same result as If you had actually 
written it. 


-STATEMENT- 


— def aul t-choi cel — 
— opti onal-thoi ce2 — 


• An arrow returning to the left above or below the item indicates an item that 
you can repeat. Required items appear on the main line and optional items 
appear below the main line. 


I 

•♦—STATEMENT repeatabl e-i tern- 


►•—STATEMENT repeatabl e-1 tear 

t 


• Keywords appear in uppercase (for example, PARM1). However, they can be 
uppercase or lowercase when they are entered. They must be spelled 
exactly as shown. Variables and acceptable values appear in all lowercase 
letters (for example, parmx). They represent names or values that you 
supply. Keywords and keywords followed by parameters (for example, 

MSG (message-id)) may be coded in any order. 

• If punctuation marks, parentheses, arithmetic operators, or other symbols 
are shown, you must enter them as part of the syntax. 
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Tag Group Summary 

Page Element 

6 Application panels 

6 Help panels and help indexes 

6 Information regions 

7 Variables 

7 Application command tables 

7 Key mapping lists 

7 Messages 
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Table 1 (Page 1 of 2). Application Panel Tags 


AB (Action Bar) 


ABC (Action Bar Choice) 


ACTION (Action) 


AREA (Area) 


ASSIGN! (Assignment List Item) 


ASSIGN L (Assignment List) 


BOTINST (Bottom Instruction) 


CHOICE (Selection Choice) 


CMDAREA (Command Area) 


DIVIDER (Divider) 


DTACOL (Data Column) 


DTAFLD (Data Field) 


DTAFLDD (Data Field Description) 


ICON (Icon Resource) 


INFO (Information Region) 


LSTCOL (Ust Column) 


LSTFLD (Ust Field) 


M (Mnemonic) 


PANDEF (Panel Definition) 


PANEL (Panel Definition) 


PDC (Pull-Down Choice) 


PDSEP (Pull-Down Separator) 


REGION (Region) 


SELCOL (Selection Column) 


SELFLD (Selection Field) 


SELLST (Selection Ust) 


TOPINST (Top Instruction) 


UC (User Control) 


Table 2. Help Panel and Help Index Tags 


Tag 


AREA (Area) 


HELP (Help Panel) 


ICMD (Index Command) 


INFO (Information Region) 


Page Tag 


ISYN (Index Synonym) 


ITOP (Index Topic) 


RP (Reference Phrase) 


SORTKEY (Sortkey) 



Table 3 (Page 1 of 2). Information Region Tags 


CAUTION (Caution) 


DD (Definition Description) 


DDHD (Definition Description Header) 


DL (Definition Ust) 


DT (Definition Term) 


DTHD (Definition Term Header) 


FIG (Figure) 


FIGCAP (Figure Caption) 


Hn (Heading) (H1-H4) 


INFO (Information Region) 


LI (List Item) 


LINES (Lines) 


LP (Ust Part) 


Tag 


NOTE (Note) 


NT (Note) 


OL (Ordered Ust) 


P (Paragraph) 


PARML (Parameter Ust) 


PD (Parameter Description) 


PT (Parameter Term) 


RP (Reference Phrase) 


SL (Simple Ust) 


UL (Unordered List) 


WARNING (Warning) 


XMP (Example) 
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Table 4. Variable Tags 

Tag 

Page 

Tag 

Page 

CHECKI (Validity Check Item) 

11 

VAROCL (Variable Declaration) 

34 

CHECKL (Validity Check List) 

12 

VARUST (Variable List) 

34 

LIT (Literal) 

22 

XLATI (Translate item) 

35 

VARCLASS (Variable Class) 

34 

XLATL (Translate List) 

36 


Table 5. Application Command Table Tags 

Tag 

Page 

Tag 

Page 

CMD (Command Definition) 

12 

CMDTBL (Command Table) 

14 

CMDACT (Command Action) 

13 

T (Truncation) 

32 ; 


Table 6. Key Mapping List Tags 

Tag 

Page 

Tag 

Page 

KEYI (Key item) 

20 

KEYL (Key Mapping Ust) 

21 


Table 7 (Page 1 of 2). Message Tags 

Tag 

Page 

Tag 

Page 

MSG (Message) 

25 

VARSUB (Variable Substitution) 

35 

MSGMBR (Message Member) 

25 
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Alphabetic Summary 

The following is an alphabetical summary of the syntax of each of the Dialog Tag 
Language tags. In addition to listing the tags, the summary shows: 

• The valid attributes and values for the tag (if any) 

• The tags that can be nested directly within each tag 

• The tags that you can code a tag within 

• The dialog elements that the tags can be coded within. 

The dialog elements that a tag can be used within will be listed beneath the 
syntax diagram, followed by the Used within and Nested tags headings. 

AB (Action Bar) 

The AB tag defines an action bar on an application panel. 


►» <AB> </AB> 


Application Panels 
Used within: PANEL 
Nested tags: ABC 

ABC (Action Bar Choice) 

The ABC tag defines a keyword, or choice in an action bar, and serves as a base 
for the pull-down choice tags. 


— 






— HELP*hel p-panel-name — 


n 

— </ABO — 



Application Panels 

Used within: AB 

Nested tags: M, PDC, PDSEP 
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ACTION (Action) 

The ACTION tag defines the action that occurs when a pull-down choice or 
selection field choice is selected. 


»► <ACTI0H ► 

»• 1 


1 — PARM- parameters — 1 


' — FARM* parameters — ' 

•— VALUE-strlng— * 


*— VALUEl»str1 ng — * VALUES-string—i 


1 

— </ACTI0N= — 1 


Application panels 
Used within: CHOICE, PDC 
Nested tags: none 

AREA (Area) 

The AREA defines the scrollable portion of a panel. 




— KARSIKW— j— 1 — j-l l—KWGINO— j~ 0 -j- 



Application Panels 
Used within: PANEL 

Nested tags: DIVIDER, DTACOL, DTAFLD, INFO, LSTFLD, REGION, SELFLD, 
SELLST, UC 


Help Panels 
Used within: HELP 
Nested tags: INFO 
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ASSIGNI (Assignment List Item) 

The ASSIGNI tag delines a list element in an assignment list. 




— VALUE-test-value— 1 

— RESULT-asslgne<J-value— 



— </ASSIGNI» — 



Application Panels 
Used within: ASSIGN L 
Nested tags: none 

ASSIGNL (Assignment List) 

The ASSIGNL tag defines an assignment list. 


E 

<AS$ IGNL — DESTVAR-destl natton-varl abl e-name 


n 


^3 



Application Panels 
Used within: DTAFLD 
Nested tags: ASSIGNI 

BOTINST (Bottom Instruction) 

The BOTINST defines a bottom instruction for a panel. 



«ouiinot» — "lnsiruction-iext 1 

</B0TINST> 1 



Application Panels 
Used within: PANEL 
Nested tags: none 
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CAUTION (Caution) 

The CAUTION tag defines a statement that alerts the user of a risk. 




— text — 



Application Panels 
Used within: LI, LP, P 

Nested tags: DL, FIG, LINES, NOTE. NT. OL, P, PARML, SL, UL, XMP 

Help Panels 
Used within: LI, LP, P 

Nested tags: FIG, LINES, NOTE, NT. OL, P. RP, SL, UL, XMP 

CHECKI (Validity Check Item) 

The CHECKI tag defines a single test of an input value within a check list. 


— ‘CHECKI — TYPE"" 


Lp A rmi- low-bound— I PARM2-hlgh-bound— I 


-PARM2-character-set— 


[-VALUES”- 


-"""CST 

— PARMl—r — EQ — | PARM2"va 1 ue-1 1st— 


-nvr 


'-CLASS — CLASS-pm-cl ass-nar 


1—PARM1 “first parameter-! ^-PARH2-second parameter-! 


- > — 

— </CHECKI> — 


Variables 

Used within: CHECKL 
Nested tags: none 
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CHECKL (Validity Check List) 

The CHECKL tag defines a list of validity checks the Dialog Manager applies to 
the input variables. 



! 

1 — MSG»message-1dentifler^ 



Variables 

Used within: VARCLASS 
Nested tags: CHECKI 


CHOICE (Selection Choice) 

The CHOICE tag defines information about a selection item in a selection field. 




IB— 



— AVAI LVAR-varl abl e-name — 1 I — CHECKVAR-check-varl abl e-name — 


n 

— HATCH— i 1 1- 

* match-string — * 



— </CH01CE> — 



Application Panels 
Used within: SELFLD 
Nested tags: ACTION, M 


CMD (Command Definition) 

The CMD defines commands. 



Application Panels 
Used within: CMDTBL 
Nested tags: CMDACT, T 
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CMDACT (Command Action) 

The CMDACT tag defines the action taken when an associated command is 
issued. 


— PASSTHRU- 
— SETVER0 — 
— BACKWARD— 


'ALIAS Intemal-conrand-naroe- 


— CANCEL— 
— CHGOEFS- 

— ENTER 

— EXIT 

—EXHELP— 


-FKA 

I — FORWARD— 


-INDEX— 


1 — CLASS-por-cl ass-name- 


I — pai 


;x 


I — HELP 

h-HELPHELP- 


— KEYS 

—LEFT 

— PANELID— 
— RETRIEVE— 
— RIGHT 


I — PARM-cl ass-parameters — I 


— </CHDACT> — 


Application Panels 
Used within: CMD 


CMDAREA (Command Area) 

The CMDAREA tag defines a command area, which includes the command 
prompt text and the command entry field. 




— PMTL0C-— | — BEFORE-i — 

* — ABOVE- — * 

1 

— connand-prompt-text — 


n 

— </CM0AREA» — 



Application Panels 
Used within: PANEL 
Nested tags: none 
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CMDTBL (Command Table) 

The CMDTBL tag defines a single place to define commands. 



Application Command Tables 
Used within: none 
Nested tags: CMD 


DD (Definition Description) 

The DD tag defines the description of a term within a definition list. 



1 

1 — definition-description — ^ ^ 

1 — </DD> — 1 



Application Command Tables 
Used within: DL 

Nested tags: DL, FIG, LINES, NOTE, NT, OL, P, PARML, SL, UL, XMP 
Help Panels 
Used within: DL 
Nested tags: P, RP 

DDHD (Definition Description Header) 

The DDHD tag defines a heading for the description column of a definition list. 



n 

— def i ni tion-descri pti on-header— ^ 

— </DDHD> — 



Application Panels 
Used within: DL 
Nested tags: none 
Help Panels 
Used within: DL 
Nested tags: RP 
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DIVIDER (Area Divider) 

The DIVIDER tag defines a blank or solid divider within an area or region. 



Application Panels 

Used within: AREA, DTACOL, PANEL, REGION 
Nested tags: none 

DL (Definition List) 

The DL tag defines a list of words or phrases and their corresponding 
definitions. 




— TSIZE— J— m— j- 

n 

— BREAK— j-^OSE—j- 

n 

— COMPACT — 

' VU V 


Application Panels 

Used within: CAUTION, DD, FIG, INFO, LI, LINES, LP, NT, PD, WARNING, XMP 

Nested tags: DD, DDHD, DT, DTHD 

Help Panels 

Used within: INFO 

Nested tags: DD, DDHD, DT, DTHD 


DT (Definition Term) 

The DT tag defines the term being defined within a definition list. 



1 

1 — definition-term— 1 ^ 

L </DT> J 



Application Panels 
Used within: DL 
Nested tags: none 
Help Panels 
Used within: DL 
Nested tags: RP 


Dialog Tag Language Tag Summary 


15 














DTACOL (Data Column) 

The DTACOL tag defines column widths for data fields (DTAFLD) and selection 
fields (SELFLD) that are coded within a DTACOL tag. 



Application Panels 

Used within: AREA, REGION, PANEL 

Nested tags: DIVIDER, DTAFLD, SELFLD 


DTAFLD (Data Field) 

The DTAFLD tag defines an input field, an output field or an input/output field. 



Application Panels 

Used within: AREA, DTACOL, PANEL, REGION 
Nested tags: DTAFLDD, ASSIGNL 


16 Dialog Tag Language Tag Summary 











DTAFLDD (Data Field Description) 

The DTAFLDD tag defines additional descriptive text that is associated with a 
data field. 




— 1 

— </DTAFLDB> — 



Application panels 
Used within: DTAFLD 
Nested tags: none 


DTHD (Definition Term Header) 

The DTHD tag defines the heading for the term column of a definition list. 




— i def 1 nl ti on-temrheader — 

n 

— </DTHD> — 



Application Panels 
Used within: DL 
Nested tags: none 
Help Panels 
Used within: DL 
Nested tags: RP 

FIG (Figure) 

The FIG tag defines the format of information so that it is set off from the 
surrounding panel and retains the format of the enclosed text. 



" '■riu 

—FRAME—i — RULE— pi 
' — NONE — ' 

— WIDTH— j— PAGE— |- 


n 

— figure-content — 



Application Panels 

Used within: CAUTION, DD, INFO, LI. LP, PD, NT, WARNING 
Nested tags: DL, FIGCAP, NOTE, NT, OL. P, PARML, SL, UL. XMP 
Help Panels 

Used within: CAUTION, INFO, LI, LP. WARNING 
Nested tags: FIGCAP, NOTE, NT, OL, P, RP, SL, UL 
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FIGCAP (Figure Caption) 

The FIGCAP tag defines a caption for a figure defined with the FIG tag. 



1 

— f 1 gure-capti on-text — 

1 c/F!GCAP> — 



Application Panels 
Used within: FIG 
Nested tags: none 
Help Panels 
Used within: FIG 
Nested tags: RP 

HELP (Help Panel) 

The HELP tag defines a help panel. 




1 — WIDTH— i— 50 r- 

l — n — ' 

^ — DEPTH- — | — IQ r- 

' — n — l 


1 — TUTORIAL-name — 1 

* — hel p-panel-tltlf 



Help Panels 
Used within: none 

Nested tags: AREA, ICMD, ISYN, ITOP 


Hn (Heading) 

The Hn tags define main topics and subtopics of information. 



1 

1 — heading-text — 

n 

L </Hn> — 1 



Application Panels 
Used within: INFO 
Nested tags: none 
Help Panels 
Used within: 
Nested tags: 


INFO 

RP (except in HI) 
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ICMD (Index Command) 

The ICMD tag designates the help panel that describes a command. 



" 'iuv — wma i-vunwaiKotn ng j 

L </lCHD> J 



Help Panels 
Used within: HELP 
Nested tags: SORTKEY 

ICON (Icon Resource) 

The ICON tag defines an icon resource from a source file that is created by an 
icon editor. 




— </lCOH> — 



INFO (Information Region) 

The INFO tag defines an information region for a panel. 




1 — WIDTH- — |— 45 j 1 

1 


Application Panels 

Used within: AREA, PANEL, REGION 

Nested tags: DL, FIG, Hn, LINES, NOTE, NT, OL. P, PARML, SL, UL, XMP 
Help Panels 
Used within: AREA 

Nested tags: DL, FIG, Hn, LINES, NOTE, NT, OL, P, PARML, SL, UL, XMP 
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ISYN (Index Synonym) 

The ISYN tag defines synonyms for help Keywords. 



jin nwi'iwnwra » sjmonjrur-Korus j 

</I$YN» — l 



Help Panels 
Used within: HELP 
Nested tags: none 

HOP (Index Topic) 

The ITOP tag defines a help index topic. 




— </IT0P> — 



Help Panels 
Used within: HELP 
Nested tags: SORTKEY 


KEYI (Key Item) 

The KEYI tag defines a key assignment within a key mapping list. 



Key Mapping Lists 
Used within: KEYL 
Nested tags: none 
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KEYL (Key Mapping List) 

The KEYL tag defines a key mapping list where keys can be mapped to 
commands. 


•*— <KEYl — HAME-key-Hst-nmre> «/KEYL> 


Key Mapping Lists 
Used within: none 
Nested tags: KEYI 

LI (List Item) 

The LI tag defines a list item within an ordered list, unordered list, or simple list. 


I 

1 

—1 tea-text — 1 

— </Ll> — 



Application Panels 
Used within: OL, SL, UL 

Nested tags: CAUTION, DL, FIG, LINES, NOTE, NT, OL, P, PARML, SL, UL, 
WARNING, XMP 

Help Panels 

Used within: OL, SL, UL 

Nested tags: CAUTION. FIG, LINES, NOTE, NT, OL, P, RP, SL, UL, WARNING, 
XMP 


LINES (Lines) 

The LINES tag defines unformatted text to be displayed at run time. 




1 — text — 1 



Application Panels 

Used within: CAUTION, DD, INFO, LI, LP, NT, PD, WARNING 
Nested tags: DL, NOTE, NT, OL, P, PARML, SL, UL, XMP 
Help Panels 

Used within: CAUTION, INFO, LI, LP, WARNING 
Nested tags: NOTE, NT, OL. P, RP, SL, UL 
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LIT (Literal) 

The LIT tag defines a string where all blanks are significant and included in the 
value. 




— 1 1 teral-dl spl ay-val ue — 

| 


Variables 

Used within: XLATI 
Nested tags: none 

LP (List Part) 

The LP tag identifies a comment or explanation within an ordered list, unordered 
list, or simple list. 



1 

— Itnpl ied-paragraph — 1 

— </U» — 



Application Panels 
Used within: OL, SL, UL 

Nested tags: CAUTION, DL, FIG, LINES, NOTE, NT, OL, P, PARML, SL, 
UL, WARNING, XMP 

Help Panels 

Used within: OL, SL, UL 

Nested tags: CAUTION, FIG, LINES, NOTE, NT, OL, P, RP, SL,UL, 
WARNING, XMP 
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LSTCOL (List Column) 

The LSTCOL tag defines a column within a list field. 



Application Panels 
Used within: LSTFLD 
Nested tags: none 
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LSTFLD (List Field) 

The LSTFLD tag defines a scrollable list that is made up of columns of data from 
array variables. 



“T T[ □ ' 

1 — KAKE-list-narae— 1 ‘ — HElP-help-panel-name — 1 




* n — * 

l—KUTOOWS-n— 1 i — HIHROWS-n — 

L-HUROHS-nJ 1— HIfWIDTH«nJ 

LkMWIOTH.0— 1 ^ — RULES — ^ 

{(ONE — 

tiORIZ — 

VERT 

BOTH 


Application Panels 

Used within: AREA, PANEL, REGION 

Nested tags: LSTCOL 

M (Mnemonic) 

The M tag defines mnemonic for a choice. 



ww— imewnic-tnoratLei 




Application Panels 

Used within: ABC, CHOICE, PDC 

Nested tags: none 
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MSG (Message) 

The MSG tag defines messages within a message member. 


** 








— MSSTYPE— ^ 

—INFO 1 — 

—WARN IKS — 
—ACT I Oft - — * 


n 

— HElP-hel p-panel-name— 

n 

-message-text — ^ 

1— </KSG> — 1 



Messages 

Used within: MSGMBR 
Nested tags: VARSUB 

MSGMBR (Message Member) 

The MSGMBR tag defines a message member. 


►* <MSGM3R — NAME-message-mentoer-name — > — </MS6KBR» 


Messages 
Used within: none 
Nested tags: MSG 

NOTE (Note) 

The NOTE tag defines a single-paragraph note. 




— note-text — 1 

— </N0TE» — 



Application Panels 

Used within: CAUTION, DD, FIG, INFO, LI. LINES, LP, PD, WARNING, XMP 


Nested tags: none 
Help Panels 

Used within: CAUTION, FiG, INFO, LI, LINES, LP, WARNING, XMP 
Nested tags: RP 
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NT (Note) 

The NT tag identifies a single- or multiple-paragraph note. 




1 — note-text — 1 

j 


Application Panels 

Used within: CAUTION, DD, FIG, INFO, LI, LINES, LP, PD, WARNING, XMP 
Nested tags: DL, FIG, LINES, OL, P, PARML, SL, UL, XMP 
Help Panels 

Used within: CAUTION, FIG, INFO, LI, LINES, LP, WARNING, XMP 
Nested tags: P, RP 


OL (Ordered List) 

The OL tag identifies an ordered list of items. 




—COMPACT— 



Application Panels 

Used within: CAUTION, DD, FIG, INFO, LI, LINES, LP, NT, PD, WARNING, XMP 
Nested tags: LI, LP 
Help Panels 

Used within: CAUTION, FIG. INFO. LI, LINES, LP, WARNING, XMP 
Nested tags: LI, LP 

P (Paragraph) 

The Ptag defines a paragraph. 



1 

— paragraph-text — 

n 

a 



Application Panels 

Used within: CAUTION, DD, FIG, INFO, LI, LINES, LP, PD, NT, WARNING, XMP 
Nested tags: CAUTION. WARNING 
Help Panels 

Used within: CAUTION, DD, FIG, INFO, LI, LINES, LP. PD, NT. WARNING, XMP 
Nested tags: CAUTION, RP. WARNING 
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PANDEF (Panel Default) 

The PANDEF tag provides defaults for the application panels that reference it. 




— KELP-hel p-panel-rtame — ^ 1 — OEPTH-n — 1 


n 

— WIOTH-n — 1 1 — KEYLIST«kejH1st-naine — 

r i 

— </PAK0EF> — 



Application Panels 
Used within: none 
Nestedtags: none 

PANEL (Panel) 

The PANEL tag defines an application panel. 


■ <PAKEL — NAME- panel -name— 


— HELP-help-panel-name — — PANDEF»pandef-1d — 


i — DEI 


^ — WIDTH— — j[6 | 1 



■■■y- > r- 

— KEYHST-key-llst-name — l— title-text— ^ 


• «/PAKEL>- 


Appiication Panels 
Used within: none 

Nested tags: AB, AREA, BOTINST, CMDAREA, DIVIDER, DTACOL, DTAFLD, INFO, 
LSTFLD, REGION, SELFLD, SELLST, TOPINST, UC 
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PARML (Parameter List) 

The PARML defines parameter terms and descriptions that you use to define a 
parameter list. 



Application Panels 

Used within: CAUTION, DO, FIG, INFO, LI, LINES, LP, NT, PD, WARNING, XMP 

Nested tags: PD, PT 

Help Panels 

Used within: INFO 

Nested tags: PD, PT 


PD (Parameter Description) 

The PD tag defines the description of the term being defined in a parameter list. 



■1 


■ 



Application Panels 
Used within: PARML 

Nested tags: DL, FIG, LINES, NOTE, NT, OL, P, PARML, SL, UL, XMP 

Help Panels 

Used within: PARML 

Nested tags: P, RP 
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PDC (Pull-Down Choice) 

The PDC tag defines information about a choice included on an action bar 
puli-down menu. 



Application Panels 
Used within: ABC 
Nested tags: ACTION, M 

PDSEP (Pull-Down Separator) 

The PDSEP tag defines a horizontal divider line on an action bar pull-down 
menu. 




L </P0SEP> — 1 



Application Panels 
Used within: ABC 
Nested tags: none 

PT (Parameter Term) 

The PT tag defines the term being defined in a parameter list. 



| 

r 

— pararaeter-tem — ' 

_ </ PT » — 



Application Panels 
Used within: PARML 
Nested tags: none 
Help Panels 
Used within: PARML 
Nested tags: RP 
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REGION (Region) 

The REGION tag defines the direction in which fields on a panel are arranged. 




— DIR— I — VERT [- 

1 — H0RI2 — > 



Application Panels 

Used within: AREA, PANEL, REGION 

Nested tags: DIVIDER, DTACOL, DTAFLD, INFO, LSTFLD, REGION, SELFLD, 
SELLST, UC 

RP (Reference Phrase) 

The RP tag specifies a word or phrase in help text that has additional help 
information with it. 


» <RP — KELP -help-panel -name — > -reference-phrase — </RP> 


Help Panels 

Used within: CAUTION, DD, DDHD, DT, DTHD, FIG, FIGCAP, Hn (excep HI), 
LI, LINES. LP. NOTE, NT, P, PD, PT, WARNING, XMP 
Nested tags: none 


SELCOL (Selection Column) 

The SELCOL tag defines the array of column data where each element of the 
array corresponds to an item in the selection list. 


H 

<$EIC01 DAT/ 





— VARCLASS-varl able-cl ass-name— 

r~ 


L </SELC0L> — ! 



Application Panels 
Used within: SELLST 
Nested tags: none 
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Application Panels 

Used within: AREA, DTACOL, PANEL, REGION 
Nested tags: CHOICE 

SELLST (Selection List) 

The SELLST tag defines a scrollable list from which the user can select choices. 



Application Panels 
Used within: PANEL 
Nested tags: SELCOL 
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SL (Simple List) 

The SL tag defines a simple list of items. 



■ 

BE 



Application Panels 

Used within: CAUTION, DD, FIG, INFO, LI, LINES, LP, NT, PD, WARNING, XMP 
Nested tags: LI, LP 
Help Panels 

Used within: CAUTION, FIG, INFO, LI, LINES, LP, WARNING, XMP 
Nested tags: LI, LP 

SORTKEY (Sortkey) 

The SORTKEY tag defines a sort key used instead of the actual command or 
index topic text when creating an index. 



sun-ney-vexc 

— </S0flTKEY> — 



Help Panels 

Used within: ICMD, ITOP 
Nested tags: none 

T (Truncation) 

The T tag designates the minimum command name that the user must enter to 
issue a command. 



1 




Application Command Tables 
Used within: CMD 
Nested tags: none 
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TOPINST (Top Instruction) 

The TOPINST tag defines a top instruction for a panel. 


►» - ■ <TnPTNST> Hncfn.rttnn-ttw'- 


— </T0PINST> — 



Application Panels 
Used within: PANEL 
Nested tags: none 

UC (User Control) 

The UC tag allows you to specify an application-defined control on a panel. 



Application Panels 

Used within: AREA, PANEL, REGION 

Nested tags: none 

UL (Unordered List) 

The UL tag identifies an unordered list, which is an indented list with a list item 
identifier in the left margin. 



Application Panels 

Used within: CAUTION. DD, FIG, INFO, LI, LINES, LP, NT, PD, WARNING, XMP 
Nested tags: LI, LP 
Help Panels 


Used within: CAUTION, FIG, INFO, LI. LINES, LP, WARNING, XMP 
Nested tags: LI, LP 
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VARCLASS (Variable Class) 

The VARCLASS defines variable class related information. 



i ire*— 


■ 









L-YES— 1 

■ 

1— HSG-message-ldentlfieJ L/varclassJ 


Variables 

Used within: none 

Nested tags: CHECKL, XLATL 

VARDCL (Variable Declaration) 

The VARDCL tag defines variables referenced in dialog elements. 


» <VARDCL — KAHE-naoe VARCLASS-varlable-class-tiaro- 


■■1 ■ > ■ -T — 

— KAXDIH-n — I— </VARDCLs— 


Variables 

Used within: VARLIST 
Nested tags: none 

VARLIST (Variable List) 

The VARLIST tag defines the method used to access variables referenced in 
dialog elements. 



Bi 

— 1 CLASS- pm-c lass-name — 



Variables 

Used within: none 

Nested tags: VARDCL 
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VARSUB (Variable Substitution) 

The VARSUB tag defines variables substituted in a message definition. 



Messages 
Used within: MSG 
Nested tags: none 

WARNING (Warning) 

The WARNING tag defines a statement that alerts the user of a possible risk. 





—text— 



Application Panels 
Used within: LI, LP. P 

Nested tags: DL, FIG, LINES, NOTE, NT, OL, P, PARML, SL, UL, XMP 

Help Panels 

Used within: LI, LP, P 

Nested tags: FIG, LINES, NOTE, NT, OL, P, RP, SL, UL, XMP 


XLATI (Translate Item) 

The XLATI tag defines an individual list element in a translation list. 




<XLATI 1 | — > 

I — 1 VALUE- i eternal -v a 1 ue— ^ 

— dl spl ayed-val ue — 1 

1 — </XLATI» — 1 



Variables 

Used within: XLATL 
Nested tags: LIT 
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XLATL (Translate List) 

The XLATL Identifies the beginning of a translate list for a variable class. 



■H 




Ml 

mmm 




I 



msmmmwmm 





■Has 

HHHm 


Variables 

Used within: VARCLASS 
Nested tags: XLATL 

XMP (Example) 

The XMP tag defines an example that will be formatted In mono-spaced font, 
exactly as it entered. 




—text— 



Application Panels 

Used within: CAUTION, DD, FIG, INFO, LI, LINES, LP, NT, PD, WARNING 
Nested tags: DL, NOTE, NT, OL, P, PARML, SL, UL 
Help Panels 

Used within: CAUTION, INFO, LI, LP, WARNING 
Nested tags: NOTE, NT, OL. P, RP, SL, UL 


36 Dialog Tag Language Tag Summary 





Nesting Order of Dialog Tag Language Tags 


The following diagrams can be used as a guide for the nesting of DTL tags. 








Nesting Order of Dialog Tag Language Tags 37 





Note: You cannot nest FIG or LINES anywhere within the FIG tag. 
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Note: You cannot nest XMP, LINES, or FIG anywhere within the XMP 
tag. 



Note: You cannot nest FIG or LINES anywhere within the FIG tag. 
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Note: You cannot nest CAUTION or WARNING anywhere within the 
CAUTION or WARNING tags. 



Note: You cannot nest FIG, LINES, or XMP anywhere within the 
XMP tag. 
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Dialog Tag Language Commands Summary 


General Rules For DTL Commands 

The following rules apply to the DTL commands: 

• The DTL commands are issued on the OS/2 command line. 

• If the filename includes any of the following special characters: semicolon (;), 
comma (,), plus sign ( + ), or the space character, the filename must be enclosed 
in double quotes. 

• If there is a semicolon (;) within the command parameters, the semicolon is 
treated as the end of the parameter list, and all subsequent characters are 
ignored. 

• All parameters are positional and must be separated by commas. 

• If you specify a list of names in a command, each name must be separated by 
either a blank or a plus sign { + ). 

• Equal signs ( = ) and colons (:) can be used interchangeably to separate an option 
and its value. 

• All options associated with the DTL commands must be preceded by the slash (/) 
symbol. 

• All options associated with the DTL commands can be abbreviated. For example, 
the /PRESERVE option associated with the DTLC command can be typed as /P. 

Generally, you can abbreviate options to their first character. However, in the 
case of the /COMPRESS, /COUNTRY, and /CODEPAGE options, the minimum 
abbreviations are the first three characters (/COM, /COU, and /COD, respectively). 
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DTLC Command 

The DTLC command creates dialog elements in HLP or DTL library files. 



Enter DTLC ? to get an online description of the DTLC parameters. 

DTLD Command 

The DTLD command deletes specified dialog elements from a DTL library. 



Enter DTLD ? to get an online description of the DTLD parameters. 
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DTLC and DTLD Exit Values 


The tables on pages 45 through 45 contain a complete listing of the DTLC and DTLD exit 
values, the result of each exit value, and the valid ID values for the /COUNTRY and 
/LANGUAGE options. 


DTLC Exit Values 

Table 8 shows and describes the exit values for DTLC. 


Table 8. DTLC exit values 

Exit value 

Meaning 

Resuft 

0 

The compiler found no 
markup errors, and issues 
no warnings or errors. 

The dialog elements are 
created unless the /SYNTAX 
option was specified. 

1 

The compiler issues a 
warning message. 

The dialog elements are 
created unless the /SYNTAX 
option was specified, 
regardless of the number of 
warnings that are 
generated. 

2 

The compiler issues an 
error message. 

No additional dialog 
elements are created, 
although syntax checking 
continues. 

4 

The compiler issues a 
severe error message. 

The compiler ends all 
processing. 


DTLD Exit Values 

Table 9 shows and describes the exit values for DTLD. 


Table 9. DTLD Exit Values 

Exit value 

Meaning 

Result 

0 

DTLD found no errors, and 
issues no warnings or 
errors. 

The DTLD call completes 
successfully. 

4 

DTLD issues a severe error 
message. 

A return code of 4 halts a 

DTLD operation. 
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DTLC Country-ID List 


Table 10 contains a complete listing of the valid country-IDs and country codes for the 
/COUNTRY parameter of the DTLC command. 

Table 10 (Page 1 of 2). DTLC Country-ID List 


ID 

Country 

Country code 

AR 

Argentina 

003 

AU 

Australia 

061 

BE 

Belgium 

032 

BO 

Bolivia 

003 

BR 

Brazil 

003 

CA 

Canada 

002, 001 

CH 

Switzerland 

041 

CL 

Chile 

003 

CN 

People's Republic of China 

086 

CO 

Colombia 

003 

CR 

Costa Rica 

003 

DD 

German Democratic Republic 

049 

DE 

Federal Republic of Germany 

049 

DK 

Denmark 

045 

EC 

Ecuador 

003 

ES 

Spain 

034 

FI 

Finland 

358 

FR 

France 

033 

GB 

United Kingdom 

044 

GT 

Guatemala 

003 

GY 

Guyana 

003 

HK 

Hong Kong 

099 

HN 

Honduras 

003 

IT 

Italy 

039 

JP 

Japan 

081 

KR 

Republic of Korea 

082 

MX 

Mexico 

003 

Nl 

Nicaragua 

003 
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Table 10 (Page 2 of 2). DTLC Country-ID List 

ID 

Country 

Country code 

NL 

Netherlands 

031 

NO 

Norway 

047 

PA 

Panama 

003 

PE 

Peru 

003 

PT 

Portugal 

351 

PY 

Paraguay 

003 

SE 

Sweden 

046 

SR 

Suriname 

003 

SV 

El Salvador 

003 

TW 

Republic of China 

088 

US 

United States 

001 

UY 

Uruguay 

003 

VE 

Venezuela 

003 
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DTLC Language-ID List 


Table 11 contains a complete listing of the valid language-IDs and language files for 
the /LANGUAGE parameter of the DTLC command. 


Table 11. DTLC Language-ID List 

ID 

Language 

Language file 

DAN 

Danish 

EDWNDAN.NLS 

DEU 

German 

EDWNDEU.NLS 

ENG 

English UK 

EDWNENG.NLS 

ENU 

English US 

EDWNENU.NLS 

ESP 

Spanish 

EDWNESP.NLS j 

FIN 

Finnish 

EDWNFIN.NLS 

FRA 

French 

EDWNFRA.NLS 

FRC 

Canadian French 

EDWNFRC.NLS 

ITA 

Italian 

EDWNITA.NLS 

NLD 

Dutch 

EDWNNLD.NLS 

NOR 

Norwegian 

EDWNNOR.NLS 

PTG 

Portuguese 

EDWNPTG.NLS 

SVE 

Swedish 

EDWNSVE.NLS 

UND 

Undefined (user-defined) 

EDWNUND.NLS 
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Markup Declaration 


Document Type Declaration 

The document type declaration (DOCTYPE) identifies the source file document type and 
the rules the source file must follow. 



ww UP! 3I3ILJ1 1 




DOCTYPE 

Indicates this is a document-type declaration. 

DM 

Indicates this is a DTL source file defining dialog elements. 

SYSTEM 

Indicates that the rules for the DOCTYPE are contained in an external file. 

[ 

Indicates the beginning of the declaration subset. The declaration subset may 
contain entity declarations and parameter entity references. 

entity-declarations 

Entity-declarations that you define for a source file must be coded within the 
declaration subset. “Entity Declarations” on page 53 contains a complete 
description of entity declarations. 

] 

Indicates the end of the declaration subset. 

Description 

The DOCTYPE declaration must appear at the top of any DTL source file specified for 
compilation with the DTLC command. Files embedded in source files that are intended 
for compilation cannot contain a DOCTYPE declaration. 

Example 

The DOCTYPE statement declares the source file as a DM type file. 
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<!doctype dm system> 

<varclass name=varc type='char 1G‘> 
<varlist> 

<vardcl name=vard varclass~varc> 
</varlist> 

<panel name=panel> 
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Entity Declarations 


Entities are symbolic names that are used to insert text into a file. 



ENTITY 

Indicates this is an entity declaration. 

% 

Indicates a parameter entity declaration. Must be followed by at least one space. 

entity-name 

The name of the entity. 

It must follow these rules: 

• One to eight (seven, if it is a parameter entity) characters in length. 

• The first character must be alphabetic (a-z or A-Z). 

• Remaining characters, if any, must be A-Z, a-z, 0-9, period (.), or hyphen (-). 

• Entity-names are case-sensitive. 

CDATA 

Indicates that any delimiter characters in entity-text will not be interpreted as 
delimiters. This allows you to define entities with tags in entity-text that will be 
interpreted as data, not as tags. 

For example the entity-text *< panel >* will not be interpreted as the PANEL tag if 
the CDATA keyword is used. 

Note: CDATA cannot be used with parameter entities, 
entity-text 

The text associated with the entity reference. The text must be enclosed in single 
or double quotes. This text must be less that 253 bytes. 

SYSTEM 

Indicates this entity refers to an external file, 
filespec 

The name of the file to which the entity refers. If this is not specified it defaults to 
the name of the entity with an extension appended. The extension depends on the 
type of entity. 

.GML is used for entities. 

.SPE is used for parameter entities. 
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Description 

Entities are symbolic names that are used to insert text into a file. The text that an 
entity refers to can be a simple string of characters or it can be the text from an entire 
file. 

An entity reference is used to insert the text associated with the entity. Entities must be 
declared in the declaration subset of the DOCTYPE declaration before they can be 
referenced. To reference the entity in the source file, the entity name is preceded by 
an ampersand (&) to indicate it is an entity or a percent sign (%) to indicate it is a 
parameter entity. Both types of entities are ended with a semicolon (;). A blank or the 
end of the line may be used to end the entity reference instead of the semicolon. 

References to entities can be made anywhere in the source file after the end of the 
DOCTYPE declaration. 

References to parameter entities can only be made in the declaration subset after they 
have been declared. 

Since entity declarations can only be made within the declaration subset, the 
parameter entity is the only way to embed a file of entity declarations. Parameter 
entities are used when an entity reference is needed in the declaration subset. 

Conditions 

If an end-of-line ends an entity reference, the end-of-line character is no longer 
processed as an end of line. Use a semicolon to end the entity reference if the end of 
line should be preserved. 

An entity reference to an entity that has been declared is not required. 

If the SYSTEM entity file cannot be found in the current directory, the DPATH is 
searched for the file. A full path may be specified for the filespec parameter if the file 
is not in the current directory or located on the DPATH. 
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Predefined Entities 


This section lists the predefined entities for the Dialog Tag Language Compiler. These 
entities should be used when the symbol desired is not present on a Keyboard, when it 
conflicts with a compiler delimiter symbol, or when it is in text that could be translated. 
The list is shown using the entity declaration format. 

You do not need to declare a predefined entity in order to use it. If you use the entity in 
your source file as you would an entity that you declare within your document subset, 
the compiler performs the translation for you. 

The Dialog Tag Language predefined entities include: 


&gtsym; 

greater than (>) 

&ttsym; 

less than (<) 

&co!on; 

colon {:) 

&amp; 

ampersand (&) 

&semi; 

semicolon (;) 

^period; 

period (.) 

&quote; 

single quote (*) 

&dquote; 

double quote ( n ) 

&ndash; 

short dash (-) 

&U8; 

underscore (J 

&or; 

logical or (|) 

&8il; 

back slash (\) 

&Ibrk; 

left bracket ([) 

&rbrk; 

right bracket (]) 

&tbrc; 

left brace ({) 

&rbrc; 

right brace (» 

&mfnus; 

minus sign (— ) 

Stplus; 

plus sign ( + ) 
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Dialog Manager Services Summary 


This chapter summarizes the Dialog Manager services syntax. For procedures 
language refer to the Dialog Manager Guide and Reference. 

ADDPOP 

Use the ADDPOP service to display panels in pop-up windows. 
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DMCLOSE 

Use the DMCLOSE service to end a dialog initiated by a DMOPEN call. 



DMOPEN 

Use the DMOPEN service to activate the Dialog Manager so that the DM application can 
issue dialog services. 


»► CALI ISPCI (dsrcocrm buflen buffer)- 


Buffer contains: 


I—APi 


'PLID{ application-id)—* *— INSTID(lnstance-id)— * UNIQUE— 
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FORCEXIT 


Use the FORCEXIT service from a non-Dialog Manager thread to cause a Dialog 
Manager thread to exit from its current DISPLAY service. Use the FORCEXIT service 
with the CLEAR parameter from a Dialog Manager thread to clear any pending 
FORCEXIT request. 

►* CALL ISPCI (dmcocnm — buflen — buffer) ►« 

Buffer Contains 
FORCEXIT 

LIBDEF 

Use the LIBDEF service to define a set of libraries dynamically. 

»» CALL ISPCI — (<fencooni — buflen buffer) 

Buffer contains: 

LIBDEF — lib-type — LIBLIST(1 ib-1 
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REMPOP 

Use the REMPOP service to remove pop-up windows created by ADDPOP service calls. 



VCOPY 

Use the VCOPY service to obtain a copy of dialog variables for your DM application. 
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VDEFINE 

Use the VDEFINE service to explicitly define dialog variables to the Dialog Manager. 



VDELETE 

Use the VDELETE service to remove explicitly defined dialog variables from the dialog 
variable pool. 
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VREPLACE 


Use the VREPLACE service to update the vaiue of a dialog variable in the dialog 
variable pool. 


»» CALL ISPCI2 (dracootn buflen buffer length-array structure)- 

Buffer contains: 

m VREPLACE name-1 1st 


VRESET 

Use the VRESET service to reset the dialog variable pool to empty. 
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Dialog Manager Commands and 
Descriptions 


The following table describes the commands supported by the Dialog Manager. The 
commands are arranged alphabetically. 

In most cases, unless the DM application uses an application command table to 
override the normal behavior of a command, the processing of the command is 
transparent to the DM application. 


Command 

Description 

ACTIONS 

Switches the cursor to the action bar. If the cursor is already 
in the action bar, it switches back to the field that previously 
had the cursor. 

The Dialog Manager restricts the use of this command to the 
F10 key only. 

BACKWARD 

If the panel has a scrollable area, and the cursor is on a field 
within that area other than a scrollable field, such as a list 
field or selection list, this command displays information 
above that currently visible. The scroll increment is the size 
of the visible area minus one line. 

If the cursor is on a scrollable field, such as a list field or 
selection list, the information in the scrollable field above 
that currently visible would be displayed. The scroll 
increment is the size of the visible scrollable field minus one 
line. 

If the cursor is not on a control in the scrollable area or on a 
scrollable field, such as a list field or selection list, this 
command is ignored. 

Note: This command is most useful if mapped to a function 
key or an action bar pull-down choice. 

CANCEL 

If CANCEL is requested from a Dialog Manager message 
pop-up, the pop-up is removed and the cursor returns to the 
field on the underlying panel that last had the cursor. 

If CANCEL is requested from a panel displayed using the 
DISPLAY service call, the Dialog Manager returns: 

• A return code of 4. 

• A reason code indicating that CANCEL was requested. 

Reason codes indicating if validation was successful or not 
are returned in the Error Information section of the DM 
communication area. 

The Dialog Manager updates the variable pool regardless of 
the outcome of validation. 
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Command 

Description 

CHGDEFS 

Displays a pop-up panel listing the current default values of 
the ZFKA, ZMSGID, and ZPANEUD system variables. In 
addition to the variable names and current values, the panel 
displays descriptions of the function provided by each 
variable. 

An ENTER action from the CHGDEFS panel removes the 
panel and causes the variable values to be updated. A 

CANCEL action removes the panel without updating the 
variable values. 

ENTER 

The ENTER command requests the processing of the current 
panel. 

If ENTER is requested from a panel displayed using the 
DISPLAY service call, the Dialog Manager returns: 

• A return code of 0 

• A reason code indicating that ENTER was requested. 

If variable validation fails, the panel will be redisplayed with 
an error message. Control will not return to the application 
on an ENTER action until all variable validation is successful. 

EXIT 

Requests that the current function be ended. 

If the current panel was displayed as a result of the DISPLAY 
service, the Dialog Manager returns: 

• A return code of 8. 

• A reason code indicating that EXIT was requested. 

Reason codes indicating if validation was successful or not 
are returned in the Error Information section of the DM 
communication area. 

The Dialog Manager updates the variable pool regardless of 
the outcome of validation. 

EXHELP 

Displays help text for an entire panel as opposed to a 
particular field within that panel. The text displayed is 
dependent on the panel that has the cursor or the pane) from 
which help was originally requested. 

FKA 

Toggles the display (on or off) of the function key area for the 
current dialog. 
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Command 

FORWARD 


Description 


if the panel has a scrollable area, and the cursor is on a field 
within that area other than a scrollable field, such as a list 
field or selection list, this command displays information 
below that currently visible. The scroll increment is the size 
of the visible area minus one line. 

If the cursor is on a scrollable field, such as a list field or 
selection list, information in the scrollable field below that 
currently visible would be displayed. The scroll increment is 
the size of the visible scrollable field minus one line. 

If the cursor is not on a control in the scrollable area or on a 
scrollable field, such as a list field or selection list, this 
command is ignored. 


Note: This command is most useful if mapped to a function 
key or an action bar pull-down choice. 


HELP 

Displays help text for a panel field, a message, a command, 
or a panel depending upon the context indicated by the 
cursor position. 

HELPHELP 

Displays a panel describing Help for help. 

INDEX 

Displays the help index panel. 

KEYS 

Displays the keys help panel named in ZKEYHELP. 

LEFT 

If the panel has a scrollable area, and the cursor is on a field 
within that area other than a scrollable field, such as a list 
field or selection list, this command displays information to 
the left of that currently visible. The scroll increment is 
one-third of the visible area. 


If the cursor is on a scrollable field, such as a list field or 
selection list, information in the scrollable field to the left of 
that currently visible would be displayed. The scroll 
increment is one-third of the visible scrollable field. 


If the cursor is not on a control in the scrollable area or on a 
scrollable field, such as a list field or selection list, this 
command is ignored. 


Note: This command is most useful if mapped to a function 
key or an action bar pull-down choice. 


PANELID Toggles the display of panel identifiers for the current dialog. 

The Dialog Manager updates the system variable ZPANELID 
to represent the current state of the panel ID option and 
saves the value in the dialog variable pool. 
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Command 


Description 


RETRIEVE Displays previously entered commands in an active 

command entry field. It is only valid when the command 
entry field has the input focus. 

The commands are displayed one at a time, in a reverse 
sequence to which they were entered (last-in, first-out). This 
allows the user to easily recall a command for resubmission 
from the command line or to edit the command before 
entering it. 

The Dialog Manager does not retain an entered command 
for retrieval when the user: 

• Enters commands using action fields 

• Enters commands using keys assigned to commands 

• Enters commands using SELFLD pull-down choice 
selections. 

The RETRIEVE command is never placed on the retrieval 
stack. 

RIGHT If the panel has a scrollable area, and the cursor is on a field 

within that area other than a scrollable field, such as a list 
field or selection list, this command displays information to 
the right of that currently visible. The scroll increment is 
one-third of the visible area. 

If the cursor is on a scrollable field, such as a list field or 
selection list, information in the scrollable field to the right of 
that currently visible would be displayed. The scroll 
increment is one-third of the visible scrollable field. 

If the cursor is not on a control in the scrollable area or on a 
scrollable field, such as a list field or selection list, this 
command is ignored. 

Note: This command is most useful if mapped to a function 
key or an action bar pull-down choice. 

Dialog Manager Keys 

The Dialog Manager automatically adds default keys to your key mapping list if you do 
not specify them in your source file. The keys are: 

Enter 

Esc = Cancel 
F3=Exit 
FI = Help 

Note: The FI key cannot be overridden although help can be assigned to another key. 
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System Variables 


The system variables are described with type and pool information in the following 
tables. Some system variables are also discussed with the Dialog Manager service to 
which they apply. 

• The first column gives the name of the variable. 

• The second column indicates the variable type. The following abbreviations are 
used: 

In Input variable, set by a DM application to provide information to the 
Dialog Manager. 

out Output variable, set by the Dialog Manager to provide information to DM 
applications. 

non Non-modifiable output variable. In some cases, the variable is 

dynamically evaluated by the Dialog Manager; for example, ZIDATE. The 
DM application cannot modify the variable. 

user User-modifiable variable. Although the DM application cannot modify 
these variables, the values can be modified by the user using DM 
commands. 

• The third column gives the maximum length of the variable. All system variables 
are in character format unless explicitly stated otherwise. Values are left justified 
and padded with blanks on the right. 

DBCS blanks will be used if the data is found to be DBCS. 

• The fourth column gives a brief description of the variable. 
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Date and Time 


Name 

Typo 

Len 

Description 

ZDATEF 

non 

8 

Dialog national language date format using 
the characters DD for day, MM for month, 
and YY for year. ZDATEF contains the 
national language date delimiter. For 
example, MM/DD/YY or DD.MM.YY. 

ZDAY 

non 

2 

Day of the month (2 characters). 

ZIDATE 

non 

6 

Current date with a two-digit year. The 
format of ZIDATE is YYMMDD (year, month, 
day). 

ZITIME 

non 

4 

Current time of day (hours and minutes) 
based on a 24-hour clock. The format is 
HHMM. 

ZJUL 

non 

6 

The current Julian date with a two-digit 
year. The format is YY.DDD. 

ZMONTH 

non 

2 

Month of the year (2 characters). 

ZSTDDATE 

non 

8 

Current date with four-digit year. The 
format is YYYYMMDD (year, month, day). 

ZSTDJUL 

non 

8 

The current Julian date with a four-digit 
year. The format is YYYY.DDD. 

ZSTDTIME 

non 

6 

Current time of day (hours, minutes, and 
seconds) based on the 24-hour clock. The 
format is HHMMSS. 

ZSTDYEAR 

non 

4 

Year (4 characters) 

ZTS 

non 

1 

Dialog national language separator 
character for ZITIME. 

ZYEAR 

non 

2 

Year (2 characters) 
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General 


Name Type Len Description 

Z non 0 Null variable. 

2APPLID non 4 Application identifier specified on the 

APPLID parameter of the DMOPEN service 
call. 

ZCMD out 256 The command name or parameters to be 

passed to the DM application for handling. 
If the action associated with the command 
is PASSTHRU, then ZCMD contains the 
command name and its parameters, if any. 
If the action is SETVERB, then ZCMD 
contains only the command parameters 
and ZVERB contains the command name. 

ZCS non 1-5 Currency symbol for the dialog national 

language. ZCS is dynamically evaluated. 

ZDS non 1 Decimal separator character for the dialog 

national language. ZDS is dynamically 
evaluated. 

ZENVIR non 32 Environment description (content is 

environment dependent). 

• 1 to 8 contain the product name, 
version, release, and modification 
level 

• 9 to 16 contain the operating system 
name 

• 17 to 32 contain blanks and are 
reserved. 

ZFKA user 1 Current setting for the function key area 

form. The default dialog-level value for 
this variable is set when the first DMOPEN 
for a dialog is issued. The user can modify 
the value of ZFKA by using the Dialog 
Manager CHGDEFS command or the 
Dialog Manager FKA command. 
Modifications to the value will be retained 
for the duration of the current dialog or 
until changed again within the dialog. 

The value is a single-character digit with 
the following meanings: 

• 0 - Do not display FKA 

• 1 - Display short form of FKA. 

The default value is 0. 
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Name 

Typo 

Len 

Description 

ZHELPTTL 

in 

255 

Character string to be used as the window 
title for the DM application's help window. 

If not specified, the application's primary 
window title will be used. 

ZKEYHELP 

in 

8 

The name of the keys help panel to be 
displayed when the KEYS command is run. 
This keys help panel remains in effect until 
you change the ZKEYHELP variable value. 

ZMSGID 

user 

1 

Current user setting that determines 
whether or not the message ID should be 
displayed. The Dialog Manager sets the 
default dialog-level value for this variable 
when the first DMOPEN for a dialog is 
issued. The user can modify the value of 
ZMSGID by using the Dialog Manager 
CHGDEFS command. Modifications to the 
value will be retained for the duration of 
the current dialog or until changed again 
within the dialog. 

The value is a single-character digit with 
the following meanings: 

* 0 - Do not display message ID 

• 1 - Display message ID. 

The default value is 0. 

ZPANELID 

user 

1 

Current setting for the panel identifier 
option. The default dialog-level value for 
this variable is set when the first DMOPEN 
for a dialog is issued. The user can modify 
the value of ZPANELID by using the Dialog 
Manager CHGDEFS command or the 

Dialog Manager PANELID command. 
Modifications to the value will be retained 
for the duration of the current dialog or 
until changed again within the dialog. 

The value is a single-character digit with 
the following meanings: 

• 0 - Do not display panel ID 

• 1 - Display panel ID. 





The default value is 0. 

ZTHS 

non 

1 

Thousands separator for the dialog 
national language. ZTHS is dynamically 
evaluated. 

ZVERB 

out 

8 

The command name to be returned to the 
program for handling, after a SETVERB 
action has occurred. The command 
parameters, if any, are returned in ZCMD. 
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Name 

Type 

Len 

Description 

ZWINICON 

in 

8 

The name of the icon defined using the 

ICON tag that is to be used on a PWS when 
the DM application's primary window is 
minimized. 

ZW1NTTL 

in 

255 

Character string to be used as the window 
title for the DM application primary 
window. The maximum length of the 
character string is 255 bytes. 


Display Characteristics 


Name 

Type 

Len 

Description 

ZDBCS 

non 

1 

The value is a single-character digit with 
the following meanings: 

• 0 — The display device does not have 
DBCS display capabilities. 

• 1 - The display device does have 

DBCS display capabilities. 


Information Returned from Display Processing 


Name 

Type 

Len 

Description 

ZCURFLD 

out 

8 

The name of the field (or list column) that 
contains the cursor when the user exits the 
panel. 

ZCURINX 

out 

5 

The subscript of the array element that 
contains the cursor when the user exits the 
panel. This system variable will contain a 
zero unless the variable displayed in the 
field specified by ZCURFLD was defined 
with the VDEFINE number-of-occurrences 
parameter. The value of ZCURINX is 
expressed in character format. 

ZCURPOS 

out 

5 

The position of the cursor within the field 
specified by ZCURFLD when the user exits 
the panel. The value of ZCURPOS is 
expressed in character format. This 
system variable will contain a zero if the 
field that had the cursor was not a list field. 


System Variables 73 









































74 



IBM United Kingdom 
International Products Limited 
PO Box 41 , North Harbour 
Portsmouth, P06 3AU 
England 


Printed in Denmark by Herrmann & Fischer A/S 



